RpcCertGeneratePrincipalNameW-Funktion (rpcssl.h)

  • Artikel

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

Syntax

RPC_STATUS RpcCertGeneratePrincipalNameW(
  PCCERT_CONTEXT Context,
  DWORD          Flags,
  RPC_WSTR       *pBuffer
);

Parameter

Context

Zeiger auf den Sicherheitszertifikatkontext.

Flags

Derzeit ist das einzige gültige Flag für diesen Parameter RPC_C_FULL_CERT_CHAIN. Die Verwendung dieses Flags bewirkt, dass der Prinzipalname im vollständigen Format generiert wird.

pBuffer

Zeiger auf einen Zeiger. Die RpcCertGeneratePrincipalName-Funktion legt dies so fest, dass auf eine null-beendete Zeichenfolge verweist, die den Prinzipalnamen enthält.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Standardmäßig ist der Prinzipalname, den die RpcCertGeneratePrincipalName-Funktion zurückgibt, im 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.

Hinweis

Der rpcssl.h-Header definiert RpcCertGeneratePrincipalName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
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 (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

Prinzipalnamen

RpcStringFree