IFileDataRetriever::GetRelativeDirectoryPath
获取文件相对于副本的根目录的路径。
HRESULT GetRelativeDirectoryPath(
LPWSTR pszDirectoryPath,
ULONG *pcchDirectoryPathLength);
参数
- pszDirectoryPath
[in, out, size_is(*pcchDirectoryPathLength)] 返回文件相对于副本的根目录的路径。此路径不以反斜杠作为其首字符。
- pcchDirectoryPathLength
[in, out] 指定 pszDirectoryPath 中的字符数。如果 pszDirectoryPath 太小,则返回检索目录所需的字符数;否则返回写入的字符数。
返回值
S_OK。
E_POINTER。
E_INVALIDARG。
如果 pszDirectoryPath 太小,则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在这种情况下,则在 pcchDirectoryPathLength 中返回必需的字符数。
备注
若要获取文件的完整相对路径,请将 pszDirectoryPath 中返回的路径与 IFileDataRetriever::GetFileInfo 返回的 WIN32_FIND_DATAW.cFileName 值中包含的文件名组合在一起。
pszDirectoryPath 中返回的路径是相对于副本的根目录的。它不使用反斜杠作为其首字符。例如,在对副本根目录中的文件调用此方法时,pszDirectoryPath 将包含空字符串 " "。