Platform SDK: Network Management

NetReplExportDirGetInfo

The NetReplExportDirGetInfo function retrieves the control information for a replicated export directory.

Security Requirements

No special group membership is required to successfully execute the NetReplExportDirGetInfo function.

NET_API_STATUS NetReplExportDirGetInfo(
  LPCWSTR servername,  
  LPCWSTR dirname,     
  DWORD level,         
  LPBYTE *bufptr       
);

Parameters

servername

[in] Pointer to a constant null-terminated Unicode string specifying the name of the remote server on which the function is to execute. The string must begin with \\. If this parameter is NULL, the local computer is used.

dirname

[in] Pointer to a constant null-terminated Unicode string specifying the export directory name about which to return control information.

level

[in] Specifies the information level of the data. This parameter can be one of the following values.

Value	Meaning
0	Return the export subdirectory name. The bufptr parameter points to a REPL_EDIR_INFO_0 structure.
1	Return the export subdirectory name and attributes. The bufptr parameter points to a REPL_EDIR_INFO_1 structure.
2	Return the export subdirectory name, attributes, and locking information. The bufptr parameter points to a REPL_EDIR_INFO_2 structure.

bufptr

[out] Pointer to the buffer that receives the data. The format of this data depends on the value of the level parameter. This buffer is allocated by the system and must be freed using the NetApiBufferFree function.

Return Values

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a Win32 API error code. For a list of error codes, see Error Codes.

Remarks

To modify the control information for an export directory, call NetReplExportDirSetInfo.

Requirements