ISCardISO7816：:P utData 方法

[ PutData 方法可用於需求一節中指定的作業系統。它不適用於 Windows Server 2003 Service Pack 1 (SP1) 及更新版本、Windows Vista、Windows Server 2008 和後續版本的作業系統。智慧卡模組提供類似的功能。]

PutData方法會建構應用程式通訊協定資料單位， (APDU) 命令，根據選取的檔案儲存單一基本資料物件或包含在建構資料物件中的資料物件集合。

物件儲存 (寫入一次和/或更新和/或附加) 的方式取決於資料物件的定義或本質。

語法

HRESULT PutData(
  [in]      BYTE         byP1,
  [in]      BYTE         byP2,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

byP1 [in]

P1-P2 的編碼。

byP2 [in]

P1-P2 的編碼。

pData [in]

位元組緩衝區的指標，其中包含要寫入的參數和資料。

ppCmd [in， out]

在輸入時， ISCardCmd 介面物件的指標或 Null。

傳回時，它會填入此作業所建構的 APDU 命令。如果ppCmd設定為Null，則會使用ppCmd指標在內部建立並傳回智慧卡ISCardCmd物件。

方法會傳回下列其中一個可能的值。

只有在安全性狀態符合應用程式在函式內容中定義的安全性條件時，才能執行命令。

儲存應用程式資料

當 P1-P2 的值位於介於 0100 到 01FF 的範圍內時，P1-P2 的值應該是保留給卡片內部測試的識別碼，以及指定應用程式內容中有意義的專屬服務。

儲存資料物件

當 P1-P2 值位於介於 0040 到 00FF 的範圍內時，P2 的值應該是單一位元組上的 BER-TLV 標記。 00FF 的值會保留為表示資料欄位具有 BER-TLV 資料物件。

當 P1-P2 的值位於 0200 到 02FF 的範圍內時，P2 的值應該是 SIMPLE-TLV 標記。值為 0200 是 RFU。值 02FF 保留為表示資料欄位攜帶 SIMPLE-TLV 資料物件。

當 P1-P2 的值位於從 4000 到 FFFF 的範圍時，P1-P2 的值應該是兩個位元組的 BER-TLV 標記。 4000 到 FFFF 的值是 RFU。

提供基本資料物件時，命令訊息的資料欄位應該包含對應基本資料物件的值。

提供建構的資料物件時，命令訊息的資料欄位應該包含建構的資料物件值， (也就是資料物件，包括其標記、長度和值) 。

如需此介面提供之所有方法的清單，請參閱 ISCardISO7816。

除了上面所列的 COM 錯誤碼之外，如果呼叫智慧卡函式以完成要求，此介面可能會傳回智慧卡錯誤碼。如需詳細資訊，請參閱智慧卡傳回值。