Funzione RpcNsProfileEltAddW (rpcnsi.h)

Articolo
11/20/2024

La funzione RpcNsProfileEltAdd aggiunge un elemento a un profilo. Se necessario, crea la voce.

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

Sintassi

RPC_STATUS RpcNsProfileEltAddW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName,
  unsigned long Priority,
  RPC_WSTR      Annotation
);

Parametri

ProfileNameSyntax

Sintassi di ProfileName.

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.

ProfileName

Puntatore al nome del profilo per ricevere un nuovo elemento.

IfId

Puntatore all'identificazione dell'interfaccia del nuovo elemento del profilo. Per aggiungere o sostituire l'elemento del profilo predefinito, specificare un valore Null.

MemberNameSyntax

Sintassi di MemberName.

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.

MemberName

Puntatore a un nome service-entry name da includere nel nuovo elemento del profilo.

Priority

Valore intero (da 0 a 7) che indica la priorità relativa per l'uso del nuovo elemento del profilo durante le operazioni di importazione e ricerca. Il valore 0 è la priorità più alta; il valore 7 è la priorità più bassa. Quando si aggiunge un membro del profilo predefinito, usare il valore 0.

Annotation

Puntatore a una stringa di annotazione archiviata come parte del nuovo elemento del profilo. Specificare un valore Null o una stringa con terminazione Null se non è presente alcuna stringa di annotazione.

La stringa viene usata dalle applicazioni solo a scopo informativo. Ad esempio, un'applicazione può usare questa stringa per archiviare la stringa del nome dell'interfaccia specificata nel file IDL. RPC non usa la stringa di annotazione durante le operazioni di ricerca o importazione o per enumerare gli elementi del profilo.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_NAME_SYNTAX	La sintassi del nome non è valida.
RPC_S_UNSUPPORTED_NAME_SYNTAX	La sintassi del nome non è supportata.
RPC_S_INCOMPLETE_NAME	Il nome è incompleto.
RPC_S_NAME_SERVICE_UNAVAILABLE	Il servizio dei nomi non è disponibile.

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

Osservazioni

La funzione RpcNsProfileEltAdd aggiunge un elemento all'attributo del profilo della voce name-service specificata da ProfileName. Se la voce ProfileName non esiste, RpcNsProfileEltAdd tenta di creare la voce con un attributo del profilo e aggiunge l'elemento del profilo specificato dal parametro ifId, MemberName, Prioritye parametri Di annotazione. In questo caso, l'applicazione deve avere il privilegio di creare la voce. In caso contrario, un'applicazione di gestione con i privilegi necessari deve creare la voce chiamando la funzione RpcNsMgmtEntryCreate prima dell'esecuzione dell'applicazione.

Se un elemento con il nome del membro e l'identificazione dell'interfaccia specificati è già presente nel profilo, RpcNsProfileEltAdd aggiorna la priorità e la stringa di annotazione dell'elemento usando i valori specificati nel Priority e parametri di annotazione.

Nota Windows 2000 Active Directory supporta questa funzione. Le versioni precedenti di Windows NT supportano l'uso di questa funzione solo con Cell Directory Service (CDS).

Nota

L'intestazione rpcnsi.h definisce RpcNsProfileEltAdd 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

RpcIfInqId

RpcNsMgmtEntryCreare

RpcNsProfileEltRemove

Condividi tramite