Поделиться через

Метод IKnownFolderManager::GetFolderIds (shobjidl_core.h)

  • Статья

Возвращает массив всех зарегистрированных идентификаторов известных папок. Это можно использовать при перечислении всех известных папок.

Синтаксис

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

Параметры

[out] ppKFId

Тип: KNOWNFOLDERID**

При возврате этим методом содержит указатель на массив всех значений KNOWNFOLDERID , зарегистрированных в системе. Используйте CoTaskMemFree, чтобы освободить эти ресурсы, когда они больше не нужны.

[in, out] pCount

Тип: UINT*

При возврате этим методом содержит указатель на количество значений KNOWNFOLDERID в массиве ppKFId. Функция [in] этого параметра не используется.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Вызывающий объект этого метода должен иметь права пользователя.

Для преобразования полученных значений KNOWNFOLDERID в строки можно использовать StringFromCLSID или StringFromGUID2.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)

См. также раздел

IKnownFolderManager

Пример: известные папки