Funzione RpcNsProfileEltInqNextA (rpcnsi.h)

Articolo
11/20/2024

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

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

Sintassi

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *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 RpcNsProfileEltInqNext 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 nell'elemento del profilo non è presente alcuna stringa di annotazione, viene restituita la stringa \0.

Specificare un valore Null per impedire RpcNsProfileEltInqNext restituire il parametro annotazione . In questo caso, l'applicazione non deve chiamare la funzione rpcStringFree .

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INCOMPLETE_NAME	Il nome è incompleto.
RPC_S_NAME_SERVICE_UNAVAILABLE	Il servizio dei nomi non è disponibile.
RPC_S_NO_MORE_ELEMENTS	Nessun altro elemento.

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

Osservazioni

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 memoria per il nome del membro restituito e la stringa di annotazione. L'applicazione è responsabile della chiamata della funzione rpcStringFree per ogni nome e stringa di annotazione del membro restituiti. 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 l'uso di questa funzione solo con Cell Directory Service (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 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

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree

Condividi tramite