Funzione RpcNsGroupMbrAddW (rpcnsi.h)

Articolo
11/20/2024

La funzione RpcNsGroupMbrAdd aggiunge un nome di voce a un gruppo. Se necessario, crea la voce.

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

Sintassi

RPC_STATUS RpcNsGroupMbrAddW(
  unsigned long GroupNameSyntax,
  RPC_WSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName
);

Parametri

GroupNameSyntax

Sintassi di GroupName.

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.

GroupName

Puntatore al nome del gruppo RPC per ricevere un nuovo membro.

MemberNameSyntax

Sintassi da usare in 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 al nome del nuovo membro del gruppo RPC.

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

Il RpcNsGroupMbrAdd aggiunge un nome di voce service-database come membro all'attributo del gruppo RPC.

Se la voce groupName non esiste, RpcNsGroupMbrAdd tenta di creare la voce con un attributo di gruppo e aggiunge il membro del gruppo specificato da MemberName. In questo caso, l'applicazione deve avere il privilegio di creare la voce. In caso contrario, un'applicazione di gestione con il privilegio necessario deve creare la voce chiamando RpcNsMgmtEntryCreate prima dell'esecuzione dell'applicazione.

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 RpcNsGroupMbrAdd 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

RpcNsGroupMbrRemove

RpcNsMgmtEntryCreare

Condividi tramite