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 codeDescription
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

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

 

 

Show: