Condividi tramite

Funzione RpcMgmtInqServerPrincName (rpcdce.h)

  • Articolo

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

Sintassi

RPC_STATUS RpcMgmtInqServerPrincName(
  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 l'applicazione (locale), specificare un 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 dell'entità registrato per il servizio di autenticazione in AuthnSvc dal server a cui fa riferimento in Binding. Se vengono registrati più nomi, viene restituito un solo nome.

Valore restituito

Valore Significato
RPC_S_OK
 La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING
 L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING
 Questo è stato il tipo di associazione sbagliato per l'operazione.
 
Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.
 

Commenti

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 alla funzione RpcStringFree per rilasciare la memoria usata da questa funzione.

Il server deve essere in ascolto delle chiamate di routine remote per la riuscita di questa funzione. Se il server non è in ascolto, la funzione ha esito negativo.

Requisiti

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 Windows
Intestazione rpcdce.h (include Rpc.h)
Libreria Rpcrt4.lib
DLL Rpcrt4.dll

Vedi anche

RpcStringFree