Funzione RpcMgmtInqServerPrincNameW (rpcdce.h)

Articolo
11/20/2024

La funzione rpcMgmtInqServerPrincName restituisce il nome dell'entità del server.

Sintassi

RPC_STATUS RpcMgmtInqServerPrincNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

Parametri

Binding

Per ricevere il nome dell'entità per un server, specificare un handle di associazione server per tale server. Per ricevere il nome dell'entità per la propria applicazione (locale), specificare il valore NULL.

AuthnSvc

Servizio di autenticazione per il quale viene restituito un nome dell'entità. I valori validi sono la costante per qualsiasi provider di sicurezza valido.

ServerPrincName

Restituisce un nome di entità registrato per il servizio di autenticazione in AuthnSvc a cui fa riferimento il server in Binding. Se vengono registrati più nomi, viene restituito un solo nome.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_BINDING	L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING	Si tratta del tipo errato di associazione per l'operazione.

Nota Per un elenco di codici di errore validi, vedere RPC Return Values.

Osservazioni

Un'applicazione chiama la funzione rpcMgmtInqServerPrincName per ottenere il nome principale di un server registrato per un servizio di autenticazione specificato.

La libreria di runtime RPC alloca la memoria per la stringa restituita in ServerPrincName. L'applicazione è responsabile della chiamata della funzione rpcStringFree per rilasciare la memoria usata da questa funzione.

Il server deve essere in ascolto delle chiamate di procedura remota affinché questa funzione abbia esito positivo. Se il server non è in ascolto, la funzione ha esito negativo.

Nota

L'intestazione rpcdce.h definisce RpcMgmtInqServerPrincName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	rpcdce.h (include Rpc.h)
libreria	Rpcrt4.lib
dll	Rpcrt4.dll

Vedere anche

RpcStringFree

Condividi tramite