RpcCertGeneratePrincipalName-Funktion (rpcssl.h)
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 |