RpcCertGeneratePrincipalName-Funktion (rpcssl.h)

  • Artikel

Serverprogramme verwenden die Funktion RpcCertGeneratePrincipalName , um Prinzipalnamen für Sicherheitszertifikate zu generieren.

Syntax

RPC_STATUS RpcCertGeneratePrincipalName(
  PCCERT_CONTEXT Context,
  DWORD          Flags,
  RPC_CSTR       *pBuffer
);

Parameter

Context

Zeiger auf den Sicherheitszertifikatkontext.

Flags

Derzeit ist das einzige gültige Flag für diesen Parameter RPC_C_FULL_CERT_CHAIN. Wenn Sie dieses Flag verwenden, wird der Prinzipalname im vollständigen Format generiert.

pBuffer

Zeiger auf einen Zeiger. Die RpcCertGeneratePrincipalName-Funktion legt dies so fest, dass sie auf eine Zeichenfolge mit NULL-Beendigung verweist, die den Prinzipalnamen enthält.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Standardmäßig hat der Prinzipalname, den die RpcCertGeneratePrincipalName-Funktion zurückgibt, das msstd-Format. Um einen Namen im vollständigen Format zu generieren, übergeben Sie RPC_C_FULL_CERT_CHAIN als Wert für den Flags-Parameter .

Ihre Anwendung muss RpcStringFree aufrufen, um den Arbeitsspeicher für die Zeichenfolge freizugeben, die den Prinzipalnamen enthält.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile rpcssl.h (einschließen von Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

Prinzipalnamen

RpcStringFree