Delen via

LocalDBStartInstance function

Applies to:SQL Server

Hiermee start u het opgegeven SQL Server Express LocalDB-exemplaar.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBStartInstance(
           PCWSTR pInstanceName ,
           DWORD dwFlags ,
           LPWSTR wszSqlConnection ,
           LPDWORD lpcchSqlConnection
);

Arguments

pInstanceName

[Invoer] De naam van het LocalDB-exemplaar dat moet worden gestart.

dwFlags

[Invoer] Gereserveerd voor toekomstig gebruik. Momenteel moet worden ingesteld op 0.

wszSqlConnection

[Uitvoer] De buffer voor het opslaan van de verbindingsreeks naar het LocalDB-exemplaar.

lpcchSqlConnection

[Input/Output] On input contains the size of the wszSqlConnection buffer in characters, including any trailing nulls. Als de opgegeven buffergrootte te klein is, bevat de uitvoer de vereiste buffergrootte in tekens, inclusief eventuele volg null-waarden.

Returns

S_OK: De functie is geslaagd.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB is niet geïnstalleerd op de computer.
LOCALDB_ERROR_INVALID_PARAMETER Een of meer opgegeven invoerparameters zijn ongeldig.
LOCALDB_ERROR_INVALID_INSTANCE_NAME De opgegeven exemplaarnaam is ongeldig.
LOCALDB_ERROR_UNKNOWN_INSTANCE Het exemplaar bestaat niet.
LOCALDB_ERROR_INSUFFICIENT_BUFFER The specified buffer wszSqlConnection is too small.
LOCALDB_ERROR_WAIT_TIMEOUT Er is een time-out opgetreden tijdens het verkrijgen van de synchronisatievergrendelingen.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Het pad waar het exemplaar moet worden opgeslagen, is langer dan MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER Een gebruikersprofielmap kan niet worden opgehaald.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER Er kan geen exemplaarmap worden geopend.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Er kan geen exemplaarregister worden geopend.
LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY Een exemplaarregister kan niet worden gewijzigd.
LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS Er kan geen proces voor SQL Server worden gemaakt.
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED Er is een SQL Server-proces gestart, maar het opstarten van SQL Server is mislukt.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Een exemplaarconfiguratie is beschadigd.
LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED Kan geen automatisch exemplaar maken. Zie het gebeurtenislogboek van de Windows-toepassing voor foutdetails.
LOCALDB_ERROR_INTERNAL_ERROR Er is een onverwachte fout opgetreden. Zie het gebeurtenislogboek voor meer informatie.

Details

Both the connection buffer argument (wszSqlConnection) and the connection buffer size argument (lpcchSqlConnection) are optional. In de volgende tabel ziet u opties voor het gebruik van deze argumenten en de bijbehorende resultaten.

Buffer Buffer size Rationale Action
NULL NULL De gebruiker wil het exemplaar starten en heeft geen pijpnaam nodig. Start een exemplaar (geen pipe return en geen vereiste buffergrootte retourneren).
NULL Present Gebruiker vraagt om de grootte van de uitvoerbuffer. (In de volgende aanroep vraagt de gebruiker waarschijnlijk om een werkelijke start.) Retourneert een vereiste buffergrootte (geen begin en geen pipe return). Resultaat is S_OK.
Present NULL Niet toegestaan; onjuiste invoer. Geretourneerd resultaat is LOCALDB_ERROR_INVALID_PARAMETER.
Present Present De gebruiker wil het exemplaar starten en heeft de pijpnaam nodig om er verbinding mee te maken nadat het is gestart. Controleert de buffergrootte, start het exemplaar en retourneert de naam van de pipe in de buffer.
Het argument buffergrootte retourneert de lengte van de tekenreeks 'server=', niet inclusief het beëindigen van null's.

Zie sql Server Express LocalDB-referentie voor een codevoorbeeld dat gebruikmaakt van de LocalDB-API van LocalDB.

Related content