IGPEInformation::GetDSPath method

The GetDSPath method retrieves the Active Directory path for the specified section of the GPO.

Syntax


HRESULT GetDSPath(
  [in]   DWORD dwSection,
  [out]  LPOLESTR pszPath,
  [in]   int cchMaxPath
);

Parameters

dwSection [in]

Specifies the GPO section. This parameter can be one of the following values.

ValueMeaning
GPO_SECTION_ROOT

Root section

GPO_SECTION_USER

User section

GPO_SECTION_MACHINE

Computer section

 

pszPath [out]

Receives the Active Directory path to the root of the requested section. For more information, see the following Remarks section.

cchMaxPath [in]

Specifies the size, in characters, of the pszPath parameter.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in the Platform SDK header file WinError.h.

Remarks

If you call the GetDSPath method and specify a computer GPO, the method succeeds, but on return, the pszPath parameter contains an empty string. This is because computer GPOs do not have Active Directory storage; they have only file system storage.

To retrieve the file system path for the specified section of a GPO, you can call the GetFileSysPath method.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Gpedit.h

DLL

Gpedit.dll

IID

IID_IGPEInformation is defined as 8FC0B735-A0E1-11d1-A7D3-0000F87571E3

See also

Group Policy Overview
Group Policy Interfaces
IGPEInformation
GetFileSysPath

 

 

Show:
© 2014 Microsoft. All rights reserved.