Expand Minimize

SslGetServerIdentity function

The SslGetServerIdentity function gets the identity of the server. This function has no associated import library. You must use the LoadLibrary and GetProcAddress functions to dynamically link to Schannel.dll.

Syntax


SECURITY_STATUS WINAPI SslGetServerIdentity(
  _In_   PBYTE ClientHello,
  _In_   DWORD ClientHelloSize,
  _Out_  PBYTE *ServerIdentity,
  _Out_  PDWORD ServerIdentitySize,
  _In_   DWORD Flags
);

Parameters

ClientHello [in]

The message from the client.

ClientHelloSize [in]

The size of the client message.

ServerIdentity [out]

The pointer inside the message where the server name starts.

ServerIdentitySize [out]

The length of the server name.

Flags [in]

This parameter is reserved and must be zero.

Return value

The status of the call to the function.

Return codeDescription
SEC_E_OK

The function was successful.

SEC_E_INVALID_PARAMETER

One of the parameters ClientHello, ServerIdentity, or ServerIdentitySize is NULL.

SEC_E_INCOMPLETE_MESSAGE

The ServerIdentitySize parameter is smaller than the ClientHelloSize parameter.

 

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Schannel.h

DLL

Schannel.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft