Share via

Método IKnownFolderManager::GetFolderIds (shobjidl_core.h)

  • Artigo

Obtém uma matriz de todas as IDs de pasta conhecida registradas. Isso pode ser usado na enumeração de todas as pastas conhecidas.

Sintaxe

HRESULT GetFolderIds(
  [out]     KNOWNFOLDERID **ppKFId,
  [in, out] UINT          *pCount
);

Parâmetros

[out] ppKFId

Tipo: KNOWNFOLDERID**

Quando esse método retorna, contém um ponteiro para uma matriz de todos os valores KNOWNFOLDERID registrados no sistema. Use CoTaskMemFree para liberar esses recursos quando eles não forem mais necessários.

[in, out] pCount

Tipo: UINT*

Quando esse método retorna, contém um ponteiro para o número de valores KNOWNFOLDERID na matriz em ppKFId. A funcionalidade [in] desse parâmetro não é usada.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O chamador desse método deve ter privilégios de usuário.

Você pode usar StringFromCLSID ou StringFromGUID2 para converter os valores KNOWNFOLDERID recuperados em cadeias de caracteres.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

IKnownFolderManager

Exemplo de pastas conhecidas