ISSCommandWithParameters::SetParameterProperties (OLE DB)

Syntaxe

HRESULT SetParameterProperties(
      DB_UPARAMS cParams, 
      SSPARAMPROPS rgParamProperties[]);

Arguments

• cParams[in]
  Nombre de structures SSPARAMPROPS dans le tableau rgParamProperties. Si ce nombre est égal à zéro, ISSCommandWithParameters::SetParameterProperties supprimera toutes les propriétés qui ont pu être spécifiées pour les paramètres dans la commande.

• rgParamProperties[in]
  Tableau de structures SSPARAMPROPS à définir.

Valeurs de code retournées

La méthode ISSCommandWithParameters::SetParameterProperties retourne les mêmes codes d'erreur que la méthode OLE DB ICommandProperties::SetProperties principale.

Notes

La définition des propriétés de paramètre avec cette méthode est autorisée pour chaque paramètre par ordinal, ou avec un appel unique à ISSCommandWithParameters::SetParameterProperties une fois SSPARAMPROPS créé à partir du tableau de propriétés.

Vous devez appeler la méthode SetParameterInfo avant d'appeler la méthode ISSCommandWithParameters::SetParameterProperties. Le fait d'appeler SetParameterProperties(0, NULL) efface toutes les propriétés de paramètre spécifiées, tandis que l'appel de SetParameterInfo(0,NULL,NULL) efface toutes les informations sur les paramètres y compris toutes les propriétés qui peuvent être associées à un paramètre.

L'appel de ISSCommandWithParameters::SetParameterProperties pour spécifier des propriétés pour un paramètre qui n'est pas du type DBTYPE_XML ou DBTYPE_UDT retourne DB_E_ERRORSOCCURRED ou DB_S_ERRORSOCCURRED et marque le champ dwStatus de tous les DBPROP contenus dans SSPARAMPROPS pour ce paramètre avec DBPROPSTATUS_NOTSET. Le tableau DBPROP de chaque DBPROPSET contenu dans SSPARAMPROPS doit être parcouru pour détecter le paramètre auquel DB_E_ERRORSOCCURRED ou DB_S_ERRORSOCCURRED fait référence.

Si ISSCommandWithParameters::SetParameterProperties est appelé pour spécifier les propriétés de paramètres dont les informations sur les paramètres n'ont pas encore été définies avec SetParameterInfo, le fournisseur retourne E_UNEXPECTED avec le message d'erreur suivant :

La méthode SetParameterProperties ne peut pas être appelée pour les paramètres spécifiés sans appeler auparavant la méthode SetParameterInfo. Vous devez définir les informations de paramètre avant de définir les propriétés de paramètre.

Si l'appel à ISSCommandWithParameters::SetParameterProperties contient des paramètres où les informations sur les paramètres ont été définies et quelques paramètres où les informations sur les paramètres n'ont pas été définies, les propriétés dwStatus dans le DBPROPSET du jeu de propriétés DBPROPSET seront retournées avec DBSTATUS_NOTSET.

La structure SSPARAMPROPS est définie comme suit :

struct SSPARAMPROPS {

DBORDINAL iOrdinal;

ULONG cPropertySets;

DBPROPSET *rgPropertySets;

};

Voir aussi

Référence