ISCardCmd::put_ReplyStatus method

[The put_ReplyStatus method is available for use in the operating systems specified in the Requirements section. It is not available for use in Windows Server 2003 with Service Pack 1 (SP1) and later, Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The Smart Card Modules provide similar functionality.]

The put_ReplyStatus method sets a new reply APDU message status word.

Syntax

HRESULT put_ReplyStatus(
  [in] WORD wStatus
);

Parameters

wStatus [in]

Word that is the status.

Return value

The method returns one of the following possible values.

Remarks

To get the reply APDU's message status word, call get_ReplyStatus.

For a list of all the methods provided by this interface, see ISCardCmd.

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For more information, see Smart Card Return Values.

Examples

The following example shows how to set a new reply APDU message status word. The example assumes that pISCardCmd is a valid pointer to an instance of the ISCardCmd interface.

WORD     wNewStatus = 0x0000;
HRESULT  hr;

// Set reply status.
hr = pISCardCmd->put_ReplyStatus(wNewStatus);
if (FAILED(hr))
{
  printf("Failed put_ReplyStatus\n");
  // Take other error handling action as needed.
}

Requirements

See also

get_ReplyStatus

ISCardCmd