IBackgroundCopyError::GetProtocol method (bits.h)

Retrieves the protocol used to transfer the file. The remote file name identifies the protocol to use to transfer the file.

Syntax

HRESULT GetProtocol(
  [out] LPWSTR *pProtocol
);

Parameters

[out] pProtocol

Null-terminated string that contains the protocol used to transfer the file. The string contains "http" for the HTTP protocol and "file" for the SMB protocol. The ppProtocol parameter is set to NULL if the error is not related to the transfer protocol. Call the CoTaskMemFree function to free ppProtocol when done.

Return value

This method returns the following HRESULT values, as well as others.

Return code Description
S_OK
Successfully retrieved the remote file protocol.
BG_E_PROTOCOL_NOT_AVAILABLE
The error is not associated with the remote file transfer protocol. The ppProtocol parameter is set to NULL.

Requirements

Requirement Value
Minimum supported client Windows XP
Minimum supported server Windows Server 2003
Target Platform Windows
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

See also

IBackgroundCopyError