Funzione MsiEnumComponentQualifiersA (msi.h)

La funzione MsiEnumComponentQualifiers enumera i qualificatori annunciati per il componente specificato. Questa funzione recupera un qualificatore ogni volta che viene chiamato.

Sintassi

UINT MsiEnumComponentQualifiersA(
  [in]      LPCSTR  szComponent,
  [in]      DWORD   iIndex,
  [out]     LPSTR   lpQualifierBuf,
  [in, out] LPDWORD pcchQualifierBuf,
  [out]     LPSTR   lpApplicationDataBuf,
  [in, out] LPDWORD pcchApplicationDataBuf
);

Parametri

[in] szComponent

Specifica il componente i cui qualificatori devono essere enumerati.

[in] iIndex

Specifica l'indice del qualificatore da recuperare. Questo parametro deve essere zero per la prima chiamata alla funzione MsiEnumComponentQualifiers e quindi incrementato per le chiamate successive. Poiché i qualificatori non sono ordinati, qualsiasi nuovo qualificatore ha un indice arbitrario. Ciò significa che la funzione può restituire qualificatori in qualsiasi ordine.

[out] lpQualifierBuf

Puntatore a un buffer che riceve il codice qualificatore.

[in, out] pcchQualifierBuf

Puntatore a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpQualifierBuf . All'input, questa dimensione deve includere il carattere null di terminazione. In caso contrario, il valore non include il carattere Null.

[out] lpApplicationDataBuf

Puntatore a un buffer che riceve i dati registrati dall'applicazione per il qualificatore. Questo parametro può essere null.

[in, out] pcchApplicationDataBuf

Puntatore a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpApplicationDataBuf . All'input, questa dimensione deve includere il carattere null di terminazione. In caso contrario, il valore non include il carattere Null. Questo parametro può essere Null solo se il parametro lpApplicationDataBuf è Null.

Valore restituito

Commenti

Per enumerare i qualificatori, un'applicazione deve inizialmente chiamare la funzione MsiEnumComponentQualifiers con il parametro iIndex impostato su zero. L'applicazione deve quindi incrementare il parametro iIndex e chiamare MsiEnumComponentQualifiers fino a quando non sono presenti altri qualificatori( ovvero finché la funzione non restituisce ERROR_NO_MORE_ITEMS).

Quando MsiEnumComponentQualifiers viene restituito, il parametro pcchQualifierBuf contiene la lunghezza della stringa del qualificatore archiviata nel buffer. Il conteggio restituito non include il carattere Null di terminazione. Se il buffer non è sufficientemente grande, MsiEnumComponentQualifiers restituisce ERROR_MORE_DATA e questo parametro contiene le dimensioni della stringa, in caratteri, senza contare il carattere Null. Lo stesso meccanismo si applica a pcchDescriptionBuf.

Quando si effettuano più chiamate a MsiEnumComponentQualifiers per enumerare tutti i qualificatori annunciati del componente, ogni chiamata deve essere eseguita dallo stesso thread.

Requisiti

Vedi anche

Funzioni di stato del sistema