Metode IComponentAuthenticate::SACAuth (mswmdm.h)

Artikel
03/15/2023

Metode SACAuth menetapkan saluran terautentikasi yang aman antar komponen.

Sintaks

HRESULT SACAuth(
  [in]  DWORD dwProtocolID,
  [in]  DWORD dwPass,
  [in]  BYTE  *pbDataIn,
  [in]  DWORD dwDataInLen,
  [out] BYTE  **ppbDataOut,
  [out] DWORD *pdwDataOutLen
);

Parameter

[in] dwProtocolID

DWORD yang berisi pengidentifikasi protokol. Untuk versi Windows Media Device Manager ini, selalu atur parameter ini ke SAC_PROTOCOL_V1.

[in] dwPass

DWORD berisi jumlah pass komunikasi saat ini. Pass terdiri dari dua pesan, satu di setiap arah. SAC_PROTOCOL_V1 adalah protokol dua-pass, dan pass bernomor 0 dan 1.

[in] pbDataIn

Arahkan ke data input.

[in] dwDataInLen

DWORD berisi panjang data yang menunjuk pbDataIn .

[out] ppbDataOut

Arahkan ke penunjuk ke data output.

[out] pdwDataOutLen

Arahkan ke DWORD yang berisi panjang data tempat ppbDataOut menunjuk .

Nilai kembali

Metode mengembalikan HRESULT. Semua metode antarmuka di Windows Media Device Manager dapat mengembalikan salah satu kelas kode kesalahan berikut:

Kode kesalahan COM standar
Kode kesalahan Windows dikonversi ke nilai HRESULT
Kode galat Pengelola Perangkat Windows Media

Untuk daftar ekstensif kemungkinan kode kesalahan, lihat Kode Kesalahan.

Keterangan

Metode ini hanya dipanggil oleh penyedia layanan. Ini disebut satu atau beberapa kali sebagaimana ditentukan oleh pengidentifikasi protokol.

Struktur data dalam pbDataIn dan ppbDataOut ditentukan oleh nilai dwProtocolID dan dwPass.

Contoh

Kode C++ berikut menunjukkan implementasi SACAuth penyedia layanan. Ini memanggil CSecureChannelServer::SACAuth pada anggota CSecureChannelServer privat yang dibuat sebelumnya.


HRESULT CMyServiceProvider::SACAuth(
    DWORD   dwProtocolID,
    DWORD   dwPass,
    BYTE   *pbDataIn,
    DWORD   dwDataInLen,
    BYTE  **ppbDataOut,
    DWORD  *pdwDataOutLen)
{
    HRESULT hr = S_OK;

    // Verify that the global CSecureChannelServer member is valid.
    if(g_pAppSCServer == NULL)
        return E_FAIL;

    hr = g_pAppSCServer->SACAuth(
        dwProtocolID,
        dwPass,
        pbDataIn, dwDataInLen,
        ppbDataOut, pdwDataOutLen
    );
    return hr;
}