IpcfGetDecryptedFilePathFromStream function

Used to get the expected, decrypted, absolute file path. Note that, this function does not actually decrypt the file.


HRESULT WINAPI IpcfGetDecryptedFilePathFromStream(
  _In_      ILockBytes pInputFileStream,
  _In_      LPCWSTR    wszInputFilePath,
  _In_      DWORD      dwFlags,
  _Out_opt_ LPCWSTR    *pwszOutputFilePath


pInputFileStream [in]

Pointer to the byte stream representing the protected file data.

wszInputFilePath [in]

Specifies file name and file extension of the file and, may contain the path to the file.

If a relative path is specified, the current working directory is used to create the absolute path.

dwFlags [in]

Specifies optional behavior for this API. For a list of valid values, see Decrypt file flags.

pwszOutputFilePath [out, optional]

On success, this parameter points to the expected full path of the decrypted file.

This should be freed using IpcFreeMemory.

Return value

If the function succeeds, the return value is S_OK. If the function fails, it returns an HRESULT value that indicates the error.

For more information, see Error codes for a description of all RMS SDK 2.1 return values.


Minimum supported client
Windows Vista with SP2
Minimum supported server
Windows Server 2008
Ipcfile.h (include Msipc.h)