Funzione RpcServerInqDefaultPrincNameW (rpcdce.h)

Articolo
11/20/2024

La funzione RpcServerInqDefaultPrincName ottiene il nome dell'entità predefinito per un determinato servizio di autenticazione.

Sintassi

RPC_STATUS RpcServerInqDefaultPrincNameW(
  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à predefinito 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 alcun obbligo di liberarlo.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_OUT_OF_MEMORY	Memoria insufficiente per completare l'operazione.

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

Osservazioni

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.

Nota

L'intestazione rpcdce.h definisce RpcServerInqDefaultPrincName 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 [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	rpcdce.h (include Rpc.h)
libreria	Rpcrt4.lib
dll	Rpcrt4.dll

Vedere anche

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo

Condividi tramite