ISCardCmd::put_Nad method

[The put_Nad 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_Nad method specifies the node address (Nad) to use with the ISCardCmd interface. This applies to communications using the T=1 protocol communications only. By default, the ISCardCmd object uses a Nad of zero.

Syntax

HRESULT put_Nad(
  [in] BYTE bNad
);

Parameters

bNad [in]

Byte representing the Nad to use.

Return value

The method returns one of the following possible values.

Return code Description
S_OK
Operation was completed successfully.
E_INVALIDARG
The bNad parameter is not valid.

 

Remarks

This method should be called only when it is necessary to use a value other than zero for the Nad.

Examples

The following example shows how to specify a node address to use with the ISCardCmd interface. The example assumes that byNadValue is a variable of type BYTE that was previously assigned a value, and that pISCardCmd is a valid pointer to an instance of the ISCardCmd interface.

HRESULT  hr;

// Set the Nad.
// byNadValue is a previously assigned BYTE value.
hr = pISCardCmd->put_Nad(byNadValue);
if (FAILED(hr))
{
  printf("Failed put_Nad\n");
  // Take other error handling action as needed.
}

Requirements

Requirement Value
Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
End of client support
Windows XP
End of server support
Windows Server 2003
Header
Scarddat.h
Type library
Scarddat.tlb
DLL
Scardssp.dll
IID
IID_ISCardCmd is defined as D5778AE3-43DE-11D0-9171-00AA00C18068

See also

ISCardCmd