Функция DSCreateISecurityInfoObject (dssec.h)

Функция DSCreateISecurityInfoObject создает экземпляр интерфейса ISecurityInformation, связанного с указанным объектом службы каталогов (DS).

Синтаксис

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Параметры

[in] pwszObjectPath

Полный путь к объекту DS, для которого создается экземпляр интерфейса ISecurityInformation .

[in] pwszObjectClass

Класс объекта, заданного параметром pwszObjectPath .

[in] dwFlags

Флаги, используемые для страницы свойств безопасности, связанной с новым экземпляром интерфейса ISecurityInformation . Этот параметр может быть любым сочетанием следующих флагов.

[out] ppSI

Указатель на экземпляр интерфейса ISecurityInformation , создаваемого этой функцией.

[in, optional] pfnReadSD

Указатель на функцию, используемую для чтения дескриптора безопасности объекта . Это значение может иметь значение NULL. Если значение pfnReadSD не равно NULL, DSCreateISecurityInfoObject вызывает функцию, на которую ссылается pfnReadSD , чтобы получить дескриптор безопасности объекта .

[in, optional] pfnWriteSD

Указатель на функцию, используемую для записи дескриптора безопасности объекта . Это значение может иметь значение NULL. Если pfnWriteSD не равно NULL, DSCreateISecurityInfoObject вызывает функцию, на которую ссылается pfnWriteSD , для записи дескриптора безопасности объекта .

[in] lpContext

Контекст для передачи в функции, определяемые параметрами pfnReadSD и pfnWriteSD .

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

Если функция завершается успешно, функция возвращает S_OK.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования