Méthode IWSDDeviceProxy ::Init (wsdclient.h)

Article
03/04/2024

Initialise le proxy d’appareil, en partageant éventuellement une session avec un proxy d’appareil sponsor précédemment initialisé.

Syntaxe

HRESULT Init(
  [in]           LPCWSTR         pszDeviceId,
  [in]           IWSDAddress     *pDeviceAddress,
  [in]           LPCWSTR         pszLocalId,
  [in, optional] IWSDXMLContext  *pContext,
  [in, optional] IWSDDeviceProxy *pSponsor
);

Paramètres

[in] pszDeviceId

Adresse logique (ID) de l’appareil.

[in] pDeviceAddress

Référence à un objet IWSDAddress qui contient les données de configuration de l’appareil.

[in] pszLocalId

Adresse logique du client. L’adresse logique se présente sous la forme urn :uuid :{guid}. Utilisé lorsque le serveur doit établir une connexion au client.

[in, optional] pContext

Référence à un objet IWSDXMLContext qui définit des types de messages ou des espaces de noms personnalisés.

Si la valeur est NULL, un contexte par défaut représentant les types de messages et espaces de noms intégrés est utilisé.

[in, optional] pSponsor

Référence à un objet IWSDDeviceProxy qui est un appareil facultatif avec lequel partager une session et des couches inférieures.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants :

Code de retour	Description
S_OK	La méthode s’est terminée avec succès.
E_INVALIDARG	pszDeviceId a la valeur NULL, pszLocalId a la valeur NULL ou la longueur en caractères de l’une ou l’autre chaîne d’identificateur dépasse WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.

Remarques

Cette méthode est appelée par WSDCreateDeviceProxy et n’a normalement pas besoin d’être appelée directement par le code client.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wsdclient.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDDeviceProxy

Partager via