Funzione RpcNsGroupMbrInqNextW (rpcnsi.h)

Articolo
11/20/2024

La funzione RpcNsGroupMbrInqNext restituisce un nome di voce da un gruppo alla volta.

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

Sintassi

RPC_STATUS RpcNsGroupMbrInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_WSTR      *MemberName
);

Parametri

InquiryContext

Handle del servizio dei nomi.

MemberName

Restituisce l'indirizzo di un puntatore a un nome membro del gruppo RPC. La sintassi del nome restituito è stata specificata dal parametro MemberNameSyntax nella funzione RpcNsGroupMbrInqBegin.

Specificare un valore Null per impedire RpcNsGroupMbrInqNext restituire il parametro MemberName . In questo caso, l'applicazione non chiama la funzione RpcStringFree .

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_NS_HANDLE	L'handle name-service non è valido.
RPC_S_NO_MORE_MEMBERS	Nessun altro membro.
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 rpcNsGroupMbrInqNext restituisce un membro del gruppo RPC specificato dal parametro GroupName in RpcNsGroupMbrInqBegin. Un'applicazione può visualizzare tutti i membri di un gruppo RPC impostato chiamando ripetutamente RpcNsGroupMbrInqNext. Quando tutti i membri del gruppo sono stati visualizzati, questa funzione restituisce un codice di stato RPC_S_NO_MORE_MEMBERS. I membri del gruppo restituiti non sono ordinati.

In ogni chiamata a RpcNsGroupMbrInqNext che restituisce un nome membro, la libreria di runtime RPC alloca memoria per l'MemberName restituito. L'applicazione è responsabile della chiamata rpcStringFree per ogni stringa Member Name restituita. Dopo aver visualizzato i membri del gruppo RPC, l'applicazione deve chiamare RpcNsGroupMbrInqDone per rilasciare il contesto di richiesta.

L'ordine in cui vengono restituiti i membri del gruppo può essere diverso per ogni visualizzazione di un gruppo. Ciò significa che l'ordine in cui i membri del gruppo vengono restituiti a un'applicazione può essere diverso ogni volta che viene eseguita l'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 RpcNsGroupMbrInqNext 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

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree

Condividi tramite