Funzione MsiSourceListEnumMediaDisksA (msi.h)

La funzione MsiSourceListEnumMediaDisks enumera l'elenco dei dischi registrati per l'origine multimediale per una patch o un prodotto.

Sintassi

UINT MsiSourceListEnumMediaDisksA(
  [in]                LPCSTR            szProductCodeOrPatchCode,
  [in, optional]      LPCSTR            szUserSid,
  [in]                MSIINSTALLCONTEXT dwContext,
  [in]                DWORD             dwOptions,
  [in]                DWORD             dwIndex,
  [out, optional]     LPDWORD           pdwDiskId,
  [out, optional]     LPSTR             szVolumeLabel,
  [in, out, optional] LPDWORD           pcchVolumeLabel,
  [out, optional]     LPSTR             szDiskPrompt,
  [in, out, optional] LPDWORD           pcchDiskPrompt
);

Parametri

[in] szProductCodeOrPatchCode

GUID ProductCode o patch del prodotto o della patch. Usare una stringa con terminazione null. Se la stringa è più lunga di 39 caratteri, la funzione ha esito negativo e restituisce ERROR_INVALID_PARAMETER. Questo parametro non può essere NULL.

[in, optional] szUserSid

SID stringa che specifica l'account utente che contiene il prodotto o la patch. Il SID non viene convalidato o risolto. Un SID non corretto può restituire ERROR_UNKNOWN_PRODUCT o ERROR_UNKNOWN_PATCH. Quando si fa riferimento a un contesto di computer, szUserSID deve essere NULL e dwContext deve essere MSIINSTALLCONTEXT_MACHINE.

[in] dwContext

Questo parametro specifica il contesto dell'istanza di prodotto o patch. Questo parametro può contenere uno dei valori seguenti.

[in] dwOptions

Valore dwOptions che specifica il significato di szProductCodeOrPatchCode.

[in] dwIndex

Indice dell'origine da recuperare. Questo parametro deve essere 0 (zero) per la prima chiamata alla funzione MsiSourceListEnumMediaDisks e quindi incrementato per le chiamate successive fino a quando la funzione restituisce ERROR_NO_MORE_ITEMS.

[out, optional] pdwDiskId

Nella voce MsiSourceListEnumMediaDisks questo parametro fornisce un puntatore a un DWORD per ricevere l'ID del disco che viene enumerato. Questo parametro è facoltativo e,

[out, optional] szVolumeLabel

Buffer di output che riceve l'etichetta del volume del disco in corso di enumerazione. Questo buffer deve essere abbastanza grande per contenere le informazioni. Se il buffer è troppo piccolo, la funzione restituisce ERROR_MORE_DATA e imposta *pcchVolumeLabel sul numero di TCHAR nel valore, non incluso il carattere NULL terminante.

Se szVolumeLabel e pcchVolumeLabel sono entrambi impostati su NULL, la funzione restituisce ERROR_SUCCESS se il valore esiste, senza recuperare il valore.

[in, out, optional] pcchVolumeLabel

Puntatore a una variabile che specifica il numero di TCHAR nel buffer szVolumeLabel . Quando la funzione restituisce, questo parametro è il numero di TCHAR nel valore ricevuto, non incluso il carattere Null terminante.

Questo parametro può essere impostato su NULL solo se szVolumeLabel è anche NULL, altrimenti la funzione restituisce ERROR_INVALID_PARAMETER.

[out, optional] szDiskPrompt

Buffer di output che riceve la richiesta del disco del disco in corso di enumerazione. Questo buffer deve essere abbastanza grande per contenere le informazioni. Se il buffer è troppo piccolo, la funzione restituisce ERROR_MORE_DATA e imposta *pcchDiskPrompt sul numero di TCHAR nel valore, non incluso il carattere NULL terminante.

Se szDiskPrompt è impostato su NULL e pcchDiskPrompt è impostato su un puntatore valido, la funzione restituisce ERROR_SUCCESS e imposta *pcchDiskPrompt sul numero di TCHAR nel valore, non incluso il carattere NULL terminante. La funzione può quindi essere chiamata di nuovo per recuperare il valore, con buffer szDiskPrompt abbastanza grande per contenere *pcchDiskPrompt + 1 caratteri.

Se szDiskPrompt e pcchDiskPrompt sono entrambi impostati su NULL, la funzione restituisce ERROR_SUCCESS se il valore esiste, senza recuperare il valore.

[in, out, optional] pcchDiskPrompt

Puntatore a una variabile che specifica il numero di TCHAR nel buffer szDiskPrompt . Quando la funzione restituisce, questo parametro viene impostato sulla dimensione del valore richiesto se la funzione copia il valore nel buffer specificato. La dimensione viene restituita come numero di TCHAR nel valore richiesto, non incluso il carattere Null terminante.

Questo parametro può essere impostato su NULL solo se szDiskPrompt è null, altrimenti la funzione restituisce ERROR_INVALID_PARAMETER.

Valore restituito

La funzione MsiSourceListEnumMediaDisks restituisce i valori seguenti.

Commenti

Quando si effettuano più chiamate a MsiSourceListEnumMediaDisks per enumerare tutte le origini per un'unica istanza del prodotto, ogni chiamata deve essere eseguita dallo stesso thread.

Un amministratore può enumerare installazioni non gestite e gestite per utente per se stessi, installazioni per ogni computer e installazioni gestite per utente per qualsiasi utente. Un amministratore non può enumerare installazioni non gestite per utente per altri utenti. Gli amministratori non possono enumerare solo le installazioni e le installazioni gestite per utente non gestite e per ogni computer.

Requisiti

Vedi anche

Contesto di installazione

Non supportato in Windows Installer 2.0 e versioni precedenti

ProductCode