Funzione RpcNsEntryExpandNameA (rpcnsi.h)

Articolo
11/20/2024

La funzione RpcNsEntryExpandName espande un nome di voce del servizio. Questa funzione è supportata da Active Directory.

Nota Questa funzione non è supportata in Windows Vista e nei sistemi operativi successivi.

Sintassi

RPC_STATUS RpcNsEntryExpandNameA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_CSTR      *ExpandedName
);

Parametri

EntryNameSyntax

Sintassi di EntryName.

Per usare la sintassi specificata nella voce del valore del Registro di sistema HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, specificare il valore RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Puntatore al nome della voce da espandere.

ExpandedName

Restituisce un puntatore a un puntatore alla versione espansa di EntryName.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INCOMPLETE_NAME	Il nome è incompleto.

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

Osservazioni

Un'applicazione chiama la funzione RpcNsEntryExpandName per ottenere un nome di voce completamente espanso.

La libreria di runtime RPC alloca memoria per il parametro ExpandedName restituito. L'applicazione è responsabile della chiamata della funzione rpcStringFree per la stringa restituita.

Il nome della voce espansa restituito è account per le traduzioni dei nomi locali e per le differenze nello schema di denominazione definito in locale.

Nota Questa funzione richiede il supporto di Active Directory.

Nota

L'intestazione rpcnsi.h definisce RpcNsEntryExpandName 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	rpcnsi.h (include Rpc.h)
libreria	Rpcns4.lib
dll	Rpcns4.dll

Vedere anche

RpcStringFree

Condividi tramite