RpcServerInqDefaultPrincNameA-Funktion (rpcdce.h)

  • Artikel

Die RpcServerInqDefaultPrincName-Funktion ruft den Standardprinzipalnamen für einen bestimmten Authentifizierungsdienst ab.

Syntax

RPC_STATUS RpcServerInqDefaultPrincNameA(
  unsigned long AuthnSvc,
  RPC_CSTR      *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, sie frei zu geben.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_OUT_OF_MEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Diese Funktion ist die empfohlene Methode zum Abrufen des Serverprinzipalsnamens, der an die RpcServerRegisterAuthInfo-Funktion übergeben werden soll. Das Komponieren des Serverprinzipalsnamens ist zwar ohne diese Funktion möglich, das Aufrufen der Funktion ist jedoch einfacher und für betriebssystemübergreifende Versionen portierbar.

Hinweis

Der rpcdce.h-Header definiert RpcServerInqDefaultPrincName 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 rpcdce.h (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo