Metode IComponentAuthenticate::SACGetProtocols (mswmdm.h)

Artikel
03/13/2024

Metode SACGetProtocols digunakan oleh komponen untuk menemukan protokol autentikasi yang didukung oleh komponen lain.

Sintaks

HRESULT SACGetProtocols(
  [out] DWORD **ppdwProtocols,
  [out] DWORD *pdwProtocolCount
);

Parameter

[out] ppdwProtocols

Penunjuk ke array protokol yang didukung. Untuk versi Windows Media Device Manager ini, ini adalah array DWORD elemen tunggal yang berisi nilai SAC_PROTOCOL_V1.

[out] pdwProtocolCount

Penunjuk ke DWORD yang berisi jumlah protokol yang dikembalikan dalam ppdwProtocols. Angkanya selalu 1 untuk versi ini.

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 kesalahan Pengelola Perangkat Windows Media

Untuk daftar ekstensif kemungkinan kode kesalahan, lihat Kode Kesalahan.

Keterangan

Metode ini diterapkan oleh penyedia layanan, dan tidak pernah dipanggil oleh aplikasi.

Contoh

Metode berikut menunjukkan implementasi penyedia layanan dari metode SACGetProtocols . Ini dilakukan dengan memanggil CSecureChannelServer::SACGetProtocols pada anggota CSecureChannelServer privatnya.


STDMETHODIMP CMyServiceProvider::SACGetProtocols(
    DWORD **ppdwProtocols,
    DWORD  *pdwProtocolCount)
{
    HRESULT hr = E_FAIL;

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

    hr = g_pAppSCServer->SACGetProtocols(
        ppdwProtocols,
        pdwProtocolCount
    );

    return hr;
}