# win32_send_custom_control

(PECL win32service >=0.4.0)

win32_send_custom_control — Envoyer un contrôle personnalisé au service

### Description

win32_send_custom_control(string `$servicename`, int `$control`, string `$machine` = `null`): void

Voir » Microsoft ControlService function pour plus de détails.

### Liste de paramètres

`servicename`

  Le nom abrégé du service.

`control`

  La valeur de contrôle personnalisé entre 128 et 255.

`machine`

  Nom de la machine en option. Si omis, l'ordinateur local est utilisé.

### Valeurs de retour

Aucune valeur n'est retournée.

Avant la version 1.0.0, retournait `WIN32_NO_ERROR` on success, `false` if there is a problem with the parameters or a Win32 Error Code on failure.

### Erreurs / Exceptions

Avant la version 1.0.0, si la valeur de contrôle n'est pas compris entre 128 et 255, cette fonction émet une erreur de niveau `E_ERROR`.

Une ValueError est levée si la valeur du paramètre `servicename` est vide.

Une ValueError est levé si la valeur du paramètre `control` n'est pas entre 128 et 255.

Une Win32ServiceException est levée en cas d'erreur.

### Historique

Version | Description
--- | ---
PECL win32service 1.0.0 | Lance une ValueError si un paramètre est invalide, avant `false` était retourné.
PECL win32service 1.0.0 | Lance une Win32ServiceException en cas d'erreur, avant un Code d'erreur Win32 était retourné.
PECL win32service 1.0.0 | Le type de retour est maintenant void, avant il était mixed.

### Voir aussi

- win32_start_service() - Démarre un service
- win32_stop_service() - Arrête un service
- win32_pause_service() - Met en pause un service
- win32_continue_service() - Reprise d'un service en pause
- Win32 Error Codes