Funzione RpcServerInqDefaultPrincName (rpcdce.h)
La funzione RpcServerInqDefaultPrincName ottiene il nome dell'entità predefinito per un determinato servizio di autenticazione.
Sintassi
RPC_STATUS RpcServerInqDefaultPrincName(
unsigned long AuthnSvc,
RPC_WSTR *PrincName
);
Parametri
AuthnSvc
Servizio di autenticazione da usare quando il server riceve una richiesta per una chiamata di procedura remota.
PrincName
Al termine dell'operazione, contiene il nome dell'entità predefinita per il servizio di autenticazione specificato dal parametro AuthnSvc . Il servizio di autenticazione in uso definisce il contenuto del nome e la relativa sintassi. Questo nome dell'entità deve essere usato come parametro ServerPrincName della funzione RpcServerRegisterAuthInfo . Se la funzione ha esito positivo, PrincName deve essere liberata usando la funzione RpcStringFree . Se la funzione non riesce, il contenuto di PrincName non è definito e il chiamante non ha l'obbligo di liberarlo.
Valore restituito
| Valore | Significato |
|---|---|
|
La chiamata ha avuto esito positivo. |
|
Memoria insufficiente per completare l'operazione. |
Commenti
Questa funzione è il modo consigliato per ottenere il nome dell'entità server da passare alla funzione RpcServerRegisterAuthInfo . Durante la composizione del nome dell'entità server è possibile senza usare questa funzione, la chiamata alla funzione è più semplice e più portabile tra le versioni del sistema operativo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcdce.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |