sp_OASetProperty (Transact-SQL)

Imposta una proprietà di un oggetto OLE su un nuovo valore.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_OASetProperty objecttoken , propertyname , newvalue [ , index... ]

Argomenti

• objecttoken
  Token di un oggetto OLE creato in precedenza tramite sp_OACreate.

• propertyname
  Nome della proprietà dell'oggetto OLE da impostare su un nuovo valore.

• newvalue
  Nuovo valore della proprietà con il tipo di dati appropriato.

• index
  Parametro di indice. Se specificato, index deve essere un valore del tipo di dati appropriato.

  Ad alcune proprietà sono associati parametri. Tali proprietà sono denominate proprietà indicizzate e i parametri corrispondenti sono denominati parametri di indice. A una proprietà possono essere associati più parametri di indice.

  [!NOTA] I parametri di questa stored procedure vengono specificati in base alla posizione, non in base al nome.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin.

Valori restituiti

0 (esito positivo) o un numero diverso da zero (esito negativo) corrispondente al valore integer del codice HRESULT restituito dall'oggetto di automazione OLE.

Per ulteriori informazioni sui codici restituiti HRESULT, vedere Codici restituiti e informazioni sugli errori di automazione OLE.

Esempi

Nell'esempio seguente viene impostata su un nuovo valore la proprietà HostName dell'oggetto SQLServer creato in precedenza.

EXEC @hr = sp_OASetProperty @object, 'HostName', 'Gizmo'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END

Vedere anche

Riferimento

Stored procedure di automazione OLE (Transact-SQL)

Altre risorse

Script di automazione OLE di esempio

Guida in linea e informazioni

Assistenza su SQL Server 2005