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 |
---|---|
|
Operation was completed successfully. |
|
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 |
|
Type library |
|
DLL |
|
IID |
IID_ISCardCmd is defined as D5778AE3-43DE-11D0-9171-00AA00C18068 |
See also