IComponentAuthenticate::SACAuth

The SACAuth method establishes a secure authenticated channel between components.

Syntax

HRESULT SACAuth(
  DWORD  dwProtocolID,
  DWORD  dwPass,
  BYTE*  pbDataIn,
  DWORD  dwDataInLen,
  BYTE**  ppbDataOut,
  DWORD*  pdwDataOutLen
);

Parameters

dwProtocolID

[in] Double word containing the protocol identifier. For this version of Windows Media Device Manager, always set this parameter to SAC_PROTOCOL_V1.

dwPass

[in] Double word containing the number of the current pass. For more information, see Remarks.

pbDataIn

[in] Pointer to the input data.

dwDataInLen

[in] Double word containing the length of the data to which pbDataIn points.

ppbDataOut

[out] Pointer to a pointer to the output data.

pdwDataOutLen

[out] Pointer to a double word containing the length of the data to which ppbDataOut points.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns E_FAIL.

Remarks

This method is called one or more times as dictated by the protocol identifier.

The structure of the data in pbDataIn and ppbDataOut is determined by the values of dwProtocolID and dwPass.

The dwPass parameter indicates the number of the communications pass that is under way. A pass consists of two messages, one in each direction. SAC_PROTOCOL_V1 is a two-pass protocol, and the passes are numbered 0 and 1.

See Also

IComponentAuthenticate Interface

Previous

Next