Funzione RpcMgmtInqServerPrincName (rpcdce.h)
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 |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
L'handle di associazione non è valido. |
|
Questo è stato il tipo di associazione sbagliato per l'operazione. |
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 |