Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

LocalDBShareInstance Function

SQL Server 2012

Shares the specified SQL Server Express LocalDB instance with other users of the computer, using the specified shared name.

Header file: sqlncli.h


          
HRESULT LocalDBShareInstance(
           PSID pOwnerSID,
           PCWSTR pInstancePrivateName,
           PCWSTR pInstanceSharedName, 
           DWORD dwFlags 
);
        
pOwnerSID

[Input] The SID of the instance owner.

pInstancePrivateName

[Input] The private name for the LocalDB instance to share.

pInstanceSharedName

[Input] The shared name for the LocalDB instance to share.

dwFlags

[Input] Reserved for future use. Currently should be set to 0.

S_OK

The function succeeded.

LOCALDB_ERROR_NOT_INSTALLED

SQL Server Express LocalDB is not installed on the computer.

LOCALDB_ERROR_INVALID_PARAMETER

One or more specified input parameters are invalid.

LOCALDB_ERROR_INVALID_INSTANCE_NAME

The specified instance name is invalid.

LOCALDB_ERROR_UNKNOWN_INSTANCE

The specified instance does not exist.

LOCALDB_ERROR_ADMIN_RIGHTS_REQUIRED

Administrator privileges are required in order to execute this operation.

LOCALDB_ERROR_SHARED_NAME_TAKEN

The specified shared name is already taken.

LOCALDB_ERROR_INSTANCE_ALREADY_SHARED

The specified instance is already shared.

LOCALDB_ERROR_INTERNAL_ERROR

An unexpected error occurred. See the event log for details.

For a code sample that uses LocalDB API, see SQL Server Express LocalDB Reference.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.