Funzione RpcNsProfileEltInqNextW (rpcnsi.h)

Articolo
03/15/2023

La funzione RpcNsProfileEltInqNext restituisce un elemento alla volta da un profilo.

Nota Questa funzione non è supportata nei sistemi operativi Windows Vista e versioni successive.

Sintassi

RPC_STATUS RpcNsProfileEltInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_WSTR      *MemberName,
  unsigned long *Priority,
  RPC_WSTR      *Annotation
);

Parametri

InquiryContext

Handle name-service restituito dalla funzione RpcNsProfileEltInqBegin .

IfId

Restituisce un puntatore all'identificazione dell'interfaccia dell'elemento del profilo.

MemberName

Restituisce un puntatore a un puntatore al nome del membro dell'elemento del profilo. La sintassi del nome restituito è stata specificata dal parametro MemberNameSyntax nella funzione RpcNsProfileEltInqBegin .

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

Priority

Restituisce un puntatore alla priorità dell'elemento del profilo.

Annotation

Restituisce un puntatore a un puntatore alla stringa di annotazione per l'elemento del profilo. Se non è presente alcuna stringa di annotazione nell'elemento del profilo, viene restituita la stringa \0.

Specificare un valore Null per impedire a RpcNsProfileEltInqNext di restituire il parametro Annotation . In questo caso, l'applicazione non deve chiamare la funzione RpcStringFree .

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INCOMPLETE_NAME	Il nome è incompleto.
RPC_S_NAME_SERVICE_UNAVAILABLE	Il servizio nome non è disponibile.
RPC_S_NO_MORE_ELEMENTS	Nessun altro elemento.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

La funzione RpcNsProfileEltInqNext restituisce un elemento dal profilo specificato dal parametro ProfileName in RpcNsProfileEltInqBegin. Indipendentemente dal valore di InquiryType in RpcNsProfileEltInqBegin, RpcNsProfileEltInqNext restituisce tutti i componenti (identificazione dell'interfaccia, nome membro, priorità, stringa di annotazione) di un elemento del profilo.

Un'applicazione può visualizzare tutte le voci del profilo selezionate chiamando ripetutamente la funzione RpcNsProfileEltInqNext . Quando tutti gli elementi sono stati visualizzati, questa funzione restituisce un codice di stato RPC_S_NO_MORE_ELEMENTS. Gli elementi restituiti non sono ordinati.

In ogni chiamata a RpcNsProfileEltInqNext che restituisce un elemento del profilo, la libreria di runtime RPC alloca la memoria per il nome del membro restituito e la stringa di annotazione. L'applicazione è responsabile della chiamata della funzione RpcStringFree per ogni nome membro restituito e stringa di annotazione. Dopo aver visualizzato gli elementi del profilo, l'applicazione deve chiamare RpcNsProfileEltInqDone per rilasciare il contesto di richiesta.

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

Nota

L'intestazione rpcnsi.h definisce RpcNsProfileEltInqNext come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcnsi.h (include Rpc.h)
Libreria	Rpcns4.lib
DLL	Rpcns4.dll

Vedi anche

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree

Condividi tramite