sp_OASetProperty (Transact-SQL)
Si applica a: 
SQL Server
Imposta una proprietà di un oggetto OLE su un nuovo valore.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
sp_OASetProperty objecttoken
, propertyname
, newvalue
[ , index... ]
[ ; ]
Argomenti
objecttoken
Token dell'oggetto di un oggetto OLE creato in precedenza da sp_OACreate.
propertyname
Nome della proprietà dell'oggetto OLE da impostare su un nuovo valore.
newvalue
Il nuovo valore della proprietà e deve essere un valore del tipo di dati appropriato.
index
Parametro di indice. Se specificato, l'indice 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.
Valori del codice restituito
0 (esito positivo) o un numero diverso da zero (errore) che corrisponde al valore intero dell'oggetto HRESULT restituito dall'oggetto automazione OLE.
Per altre informazioni sui codici restituiti HRESULT, vedere Codici restituiti di automazione OLE e informazioni sugli errori.
Autorizzazioni
È richiesta l'appartenenza al ruolo predefinito del server sysadmin o l'autorizzazione di esecuzione direttamente in questa stored procedure. L'opzione di configurazione del server Ole Automation Procedures deve essere abilitata per utilizzare qualsiasi procedura di sistema correlata all'automazione OLE.
Esempi
Nell'esempio seguente la HostName proprietà (dell'oggetto creato SQLServer in precedenza) viene impostata su un nuovo valore.
EXEC @hr = sp_OASetProperty @object,
'HostName',
'Gizmo';
IF @hr <> 0
BEGIN
EXEC sp_OAGetErrorInfo @object
RETURN
END;