Condividi tramite

Funzione RpcNsProfileEltInqBeginA (rpcnsi.h)

  • Articolo

La funzione RpcNsProfileEltInqBegin crea un contesto di richiesta per la visualizzazione degli elementi in un profilo.

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

Sintassi

RPC_STATUS RpcNsProfileEltInqBeginA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  unsigned long InquiryType,
  RPC_IF_ID     *IfId,
  unsigned long VersOption,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  RPC_NS_HANDLE *InquiryContext
);

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 da visualizzare.

InquiryType

Tipo di richiesta da eseguire sul profilo. Nella tabella seguente sono elencati i tipi di richiesta validi.

Tipo di richiesta Significato
RPC_C_PROFILE_DEFAULT_ELT
 Cerca nel profilo l'elemento del profilo predefinito, se presente. I parametriIfId VersOptione MemberName vengono ignorati.
RPC_C_PROFILE_ALL_ELTS
 Restituisce ogni elemento dal profilo. I parametriIfId VersOptione MemberName vengono ignorati.
RPC_C_PROFILE_MATCH_BY_IF
 Cerca nel profilo gli elementi che contengono l'identificazione dell'interfaccia specificata da IfId e VersOption. Il parametro MemberName viene ignorato.
RPC_C_PROFILE_MATCH_BY_MBR
 Cerca nel profilo gli elementi che contengono MemberName. I parametri di IfId e VersOption vengono ignorati.
RPC_C_PROFILE_MATCH_BY_BOTH
 Cerca nel profilo gli elementi che contengono l'identificazione dell'interfaccia e il membro identificati dai parametri IfId, VersOptione MemberName.

IfId

Puntatore all'identificazione dell'interfaccia degli elementi del profilo da restituire dalla funzione RpcNsProfileEltInqNext.

Il parametro IfId viene utilizzato solo quando si specifica un valore di RPC_C_PROFILE_MATCH_BY_IF o RPC_C_PROFILE_MATCH_BY_BOTH per il parametro InquiryType. In caso contrario, ifId viene ignorato e può essere specificato un valore Null.

VersOption

Specifica il modo in cui la funzione RpcNsProfileEltInqNext usa il parametro IfId . Questo parametro viene usato solo quando si specifica un valore di RPC_C_PROFILE_MATCH_BY_IF o RPC_C_PROFILE_MATCH_BY_BOTH per InquiryType. In caso contrario, questo parametro viene ignorato e può essere specificato un valore 0.

Nella tabella seguente vengono descritti i valori validi per VersOption.

Valore Significato
RPC_C_VERS_ALL
 Restituisce gli elementi del profilo che offrono l'UUID dell'interfaccia specificato, indipendentemente dai numeri di versione. Per questo valore, specificare 0 per le versioni principali e secondarie in IfId.
RPC_C_VERS_COMPATIBLE
 Restituisce gli elementi del profilo che offrono la stessa versione principale dell'UUID dell'interfaccia specificata e una versione secondaria maggiore o uguale alla versione secondaria dell'UUID dell'interfaccia specificata.
RPC_C_VERS_EXACT
 Restituisce gli elementi del profilo che offrono la versione specificata dell'UUID dell'interfaccia specificata.
RPC_C_VERS_MAJOR_ONLY
 Restituisce gli elementi del profilo che offrono la stessa versione principale dell'UUID dell'interfaccia specificata (ignora la versione secondaria). Per questo valore, specificare 0 per la versione secondaria in IfId.
RPC_C_VERS_UPTO
 Restituisce gli elementi del profilo che offrono una versione dell'UUID dell'interfaccia specificata minore o uguale alla versione principale e secondaria specificata. Ad esempio, se il IfId contenuto V2.0 e il profilo contiene elementi con V1.3, V2.0 e V2.1, la funzione RpcNsProfileEltInqNext restituisce elementi con V1.3 e V2.0.

MemberNameSyntax

Sintassi di MemberNamee il parametro restituito MemberName nella funzione RpcNsProfileEltInqNext.

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 membro che la funzione RpcNsProfileEltInqNext cerca negli elementi del profilo. Il parametro MemberName viene utilizzato solo quando si specifica un valore di RPC_C_PROFILE_MATCH_BY_MBR o RPC_C_PROFILE_MATCH_BY_BOTH per InquiryType. In caso contrario, MemberName viene ignorato e può essere specificato un valore Null.

InquiryContext

Restituisce un puntatore a un handle name-service da usare con le funzioni RpcNsProfileEltInqNext e RpcNsProfileEltInqDone.

Valore restituito

Valore Significato
RPC_S_OK
 Chiamata riuscita.
RPC_S_INVALID_VERS_OPTION
 L'opzione di versione non è valida.
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_ENTRY_NOT_FOUND
 Impossibile trovare la voce name-service.
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 RpcNsProfileEltInqBegin crea un contesto di richiesta per la visualizzazione degli elementi in un profilo.

Usando il parametro InquiryType, un'applicazione specifica quali degli elementi del profilo seguenti devono essere restituiti dalle chiamate a RpcNsProfileEltInqNext:

  • Elemento predefinito
  • Tutti gli elementi
  • Elementi con l'identificazione dell'interfaccia specificata
  • Elementi con il nome del membro specificato
  • Elementi con l'identificazione dell'interfaccia e il nome del membro specificati
Prima di chiamare RpcNsProfileEltInqNext, l'applicazione deve prima chiamare RpcNsProfileEltInqBegin per creare un contesto di richiesta.

Al termine della visualizzazione degli elementi del profilo, l'applicazione chiama la funzione RpcNsProfileEltInqDone per eliminare 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 RpcNsProfileEltInqBegin 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

RpcNsProfileEltInqDone

RpcNsProfileEltInqNext