3.1.4.43 NetrDfsManagerReportSiteInfo (Opnum 52)

The NetrDfsManagerReportSiteInfo method obtains a list of names that SHOULD<166> correspond to the Active Directory sites covered by the specified server. An implementation MAY<167> choose to support this method.

 NET_API_STATUS NetrDfsManagerReportSiteInfo(
   [in, string, unique] SRVSVC_HANDLE ServerName,
   [in, out, unique] LPDFS_SITELIST_INFO* ppSiteInfo
 );

ServerName: An SRVSVC_HANDLE (section 2.2.1.1) pointer that identifies the server. The client MUST map this structure to an RPC binding handle (see [C706] sections 4.3.5 and 5.1.5.2).

ppSiteInfo: A pointer to an LPDFS_SITELIST_INFO structure, which in turn points to the location of a DFS_SITELIST_INFO structure in which the information is returned.

Return Values: The method returns 0x00000000 (NERR_Success) to indicate success; otherwise, it returns a nonzero error code. The method can take any specific error code value, as specified in [MS-ERREF] section 2.2.

The ppSiteInfo parameter is a pointer to a LPDFS_SITELIST_INFO member, which in turn points to the location of a DFS_SITELIST_INFO structure in which the information is returned. That structure has a cSites member that the server SHOULD set to the number of sites returned. The information about the sites themselves MUST be returned in the Site member, which is an array of DFS_SITENAME_INFO structures. The sites the server returns are implementation-specific.<168>

The server MAY<169> enforce security measures to verify that the caller has the required permissions to execute this call. If the server enforces these security measures and the caller does not have the required credentials, the server SHOULD<170> fail the call.