3.1.5.1.2 SamrConnect4 (Opnum 62)

The SamrConnect4 method obtains a handle to a server object.

 long SamrConnect4(
   [in, unique, string] PSAMPR_SERVER_NAME ServerName,
   [out] SAMPR_HANDLE* ServerHandle,
   [in] unsigned long ClientRevision,
   [in] unsigned long DesiredAccess
 );

ServerName: The null-terminated NETBIOS name of the server; this parameter MAY<45> be ignored on receipt.

ServerHandle: An RPC context handle, as specified in section 2.2.7.2.

ClientRevision: Indicates the revision (for this protocol) of the client. The value MUST be set to 2 and MUST be ignored.

DesiredAccess: An ACCESS_MASK that indicates the access requested for ServerHandle on output. See section 2.2.1.3 for a listing of possible values.

The server MUST behave as with a call to SamrConnect5, with the following parameter values.

Parameter name

Parameter value

ServerName

SamrConnect4.ServerName

DesiredAccess

SamrConnect4.DesiredAccess

InVersion

1

InRevisionInfo

SAMPR_REVISION_INFO_V1.Revision = {2}

SAMPR_REVISION_INFO_V1.SupportedFeatures = {0}

OutVersion

Output ignored

OutRevisionInfo

Output ignored

ServerHandle

SamrConnect4.ServerHandle