Метод 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) |