RpcServerInqDefaultPrincName-Funktion (rpcdce.h)
Die RpcServerInqDefaultPrincName-Funktion ruft den Standardprinzipalnamen für einen bestimmten Authentifizierungsdienst ab.
Syntax
RPC_STATUS RpcServerInqDefaultPrincName(
unsigned long AuthnSvc,
RPC_WSTR *PrincName
);
Parameter
AuthnSvc
Authentifizierungsdienst, der verwendet werden soll, wenn der Server eine Anforderung für einen Remoteprozeduraufruf empfängt.
PrincName
Enthält bei Erfolgreicher Ausführung den Standardprinzipalnamen für den angegebenen Authentifizierungsdienst, wie durch den AuthnSvc-Parameter angegeben. Der verwendete Authentifizierungsdienst definiert den Inhalt des Namens und seine Syntax. Dieser Prinzipalname muss als ServerPrincName-Parameter der RpcServerRegisterAuthInfo-Funktion verwendet werden. Wenn die Funktion erfolgreich ist, muss PrincName mithilfe der RpcStringFree-Funktion freigegeben werden. Wenn die Funktion fehlschlägt, ist der Inhalt von PrincName undefiniert, und der Aufrufer ist nicht verpflichtet, ihn frei zu geben.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen. |
Hinweise
Diese Funktion wird empfohlen, um den Serverprinzipalnamen abzurufen, der an die RpcServerRegisterAuthInfo-Funktion übergeben werden soll. Das Komponieren des Serverprinzipalsnamens ist zwar ohne verwendung dieser Funktion möglich, aber das Aufrufen der Funktion ist für betriebssystemübergreifende Versionen einfacher und portierbarer.
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 | rpcdce.h (rpc.h einschließen) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |